# Contributing

Here is a dedicated page for people willing to contribute to Sheriff53 blocklists

Contributions are welcome, and they are greatly appreciated! Every little bit
helps, and credit will always be given.

## Submit Feedback

The best way to send feedback is to file an issue at https://notabug.org/phronimon/sheriff53blocklists/issues

## Analyze Your Own List of Pages

Use Sheriff53 to analyze pages of your choosing.

Download and install [Sheriff53](https://notabug.org/phronimon/Sheriff53)

## Other tools to detect third parties trackers

### uBO-Scope/uBlock Origin/uMatrix browser addons

The simple way to detect third party trackers is to use [uBO-Scope](https://github.com/gorhill/uBO-Scope).
This simple addon will inform you about your own third-party exposure on the web pages you visit.
You can export the data. This will create a JSON file my-uboscope.txt containing the
data uBO-Scope uses to calculate 3rd-party exposure scores.

You can also contribute by running [uBlock Origin](https://github.com/gorhill/uBlock)
in Advanced mode and/or [uMatrix](https://github.com/gorhill/uMatrix).

To change to uBlock Advanced-user mode, go to `Click To Open Dashboard` and select
the checkbox `I am an advanced user`.

After reading the [uBlock wiki: Dynamic filtering: quick guide](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-quick-guide),
start blocking the bad domanains in the websites you visit.

The data is stored in the browser and can be exported to a text file.
Go to uBlock dashboard -> My rules and export to file. The same applies to uMatrix.

Note that Sheriff53 is able to extract the domains from uBlock/uMatrix rulelists.


### Online Tools

 - [Webbkoll](https://webbkoll.dataskydd.net/)
 - [Blacklight](https://themarkup.org/blacklight)
 - [Pagexray](https://pagexray.fouanalytics.com/)
 - [Request Map](https://requestmap.webperf.tools)

### OpenWPM

For a detail analysis you can run OpenWPM web privacy measurement framework by Mozilla.
Read the instructions [here](https://github.com/mozilla/OpenWPM).

For more info read [How to Find the Third-Parties on Your Site](https://simonhearne.com/2015/find-third-party-assets/)

## List Reports

Before open an issue read the [CRITERIA](CRITERIA.md) to block a website or service.

### Report a false positive (a domain being blocked that shouldn't)

Create an issue (or PR) on this repository with the reason why the domain shouldn't be blocked.

### Report a missing domain (a domain that should be blocked but isn't)

Create an issue (or PR) on this repository. If a domain needs to be added, please detail the
steps you made to get this domain queried.

## Getting Help

If you are having problems installing the software or find bugs, please open an issue.
